home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / tbox3_21.zip / install.exe / TaskBox.txt < prev    next >
Text File  |  1997-08-21  |  11KB  |  305 lines
  1.                                   TaskBox V3.21
  2.                                   -------------
  3. Description: A simple OS/2 task manager
  4.  
  5. 0.  Contents
  6. ------------
  7.  
  8. 1.  Files
  9. 2.  Installation
  10. 3.  Usage
  11. 3.1 Running
  12. 3.2 General
  13. 3.2.1 Activating
  14. 3.2.2 Mouse+keyboard Usage
  15. 3.2.3 TaskBox menu
  16. 3.2.4 Task menu
  17. 3.3 Settings
  18. 4.  Getting in touch
  19. 4.1 Updates
  20. 5.  Misc
  21. 6   Legal
  22.  
  23. 1.  Files
  24. ---------
  25.  
  26.     TaskBox.txt         --  this file
  27.     TaskBox.exe         --
  28.     TaskBox.dll         --
  29.     ka_crt1m.dll         --  common code dll
  30.     ka_com1.dll          --
  31.     install.cmd
  32.     Clock\              --  directory containing clock module
  33.     AppStart\           --  directory containing appstart module
  34.     res__src.zip        --  source resource files
  35.  
  36. 2.  Installation
  37. ----------------
  38.  
  39.     In most cases running the install script should be sufficient.
  40.  
  41.     However if you don't use the wps or want to start TaskBox( or the clock) from a
  42. command prompt you may want to add the directory that the files are contained in to
  43. the libpath and path statements in the config.sys file.
  44.  
  45. 3.  Usage
  46. ---------
  47.  
  48.     I hope you find this program relatively self explanatory, but if you do have a
  49. problem and can't find the solution in this document you can always e-mail me.
  50.  
  51.     command line args
  52.     -----------------
  53.         /WATCH <timeout>    - to customize the length of time the taskbox will allow for task to respond
  54.                               to messages( timeout is in tenth's of a second).
  55.                               To disable this set the timeout to -1.
  56.  
  57.         /P:?                - used to set priority program runs at
  58.                               ? mark should be one of
  59.                                 I   -   to run at idle time
  60.                                 R   -   to run at regular priority
  61.                                 F   -   to run at foreground server priority
  62.  
  63.         /WC:<OBJECTID>      - activate( or moves window to top)
  64.                                when mouse moves over activation bar
  65.                                Hint! with Warp 4 specify /WC:WARPCENTER and size TaskBox
  66.                                      to just below( or above ) the warpcenter so it looks like one unit
  67.  
  68.  
  69.         /TITLE:*           -  where  * is alternative name for the activation bar, and TaskBox
  70.                               to have( primarily provided for use with multi-desktop utilities,
  71.                                  as with sticky windows most do a substring match and so any window
  72.                                  with TaskBox in the title ends up being sticky.
  73.                                  I'm currently using /TITLE:zxcvbnm
  74.                                  as i don`t think  i'll ever label a folder with this name )
  75. 3.1 Running
  76. -----------
  77.  
  78.     To run TaskBox double click the WPS icon( or alternatively enter a command prompt and
  79. change to the directory in which TaskBox is contained in( eg cd D:\bin\TaskBox ) and then
  80. type TaskBox ).
  81.  
  82. 3.2 General
  83. -----------
  84.  
  85. 3.2.1 Activating
  86. ----------------
  87.     To make the TaskBox Visible( or move it to the top if already on screen) move the mouse
  88. over the activation bar.
  89.  
  90. 3.2.2 Mouse Usage
  91. -----------------
  92.  
  93.   Mouse button 1(or 3)          --   Pressing on a task button causes that button to be hilited.
  94.                                      <Ctrl> + clicking on buttons allows multiple discrete selection
  95.                                     ( you may also drag the mouse over the buttons to multiple
  96.                                      select them).
  97.                                      If however you release the button on the same task button
  98.                                    you`ll access a menu short cut( see Button Actions $3.3 ).
  99.  
  100.                                    Hint! for those of you without 3 button mouse use <Alt>
  101.                                        mouse button 1 to simulate the 3rd mouse button
  102.  
  103.   Mouse button 2 click          --   If mouse is over a task button Task menu will be opened,
  104.                                     otherwise open the TaskBox menu.
  105.  
  106.  
  107.   Resizing                      --  Resize as you would a normal window( NB: if lock size is selected
  108.                                     you won't be able to resize te taskbox )
  109.   Moving                        --  Press and hold mouse button 2 and move the window to
  110.                                     the desired location.( NB: if lock pos is selected the taskbox
  111.                                     won't move );
  112.  
  113.   Changing fonts                --  Open the `Font Palette` and drag `n` drop the desired font
  114.                                     on to the target window.
  115.   Changing colour`s             --  Open one of the `Color Palettes` repeat as above.
  116.   Changing scheme               --  Open the `Scheme Palette` repeat as above.
  117.                                 Hint! You can use the `Scheme Palette` to change the border
  118.                                     size to a small border to conserve on screen space.
  119.  
  120.  
  121. 3.2.4 TaskBox menu
  122. ------------------
  123.     i)   Lower           --    To Lower the TaskBox
  124.     ii)  Settings        --    Enter the Settings Dialog
  125.     iii) Size            --    to size the TaskBox
  126.     iv)  Move            --    to move the TaskBox
  127.     v)   Quit            --    Quit this program
  128.  
  129. 3.2.5 Task menu
  130. ---------------
  131.     i)   show            --  activate selected tasks
  132.     ii)  lower           --  lower the task(s)
  133.     iii) tile            --  tile the task(s)( doesn`t work very well when the TaskBox is not
  134.                              on the edge of the screen and is alway`s visible  )
  135.     iv)  cascade         --
  136.     v)   system menu     --  access the task's system menu (NB: shortcut`s listed won`t work )
  137.     vi)  remove from TaskBox -- remove selected task(s) from TBox
  138.     vii) TaskBox         --  access TaskBox menu
  139.  
  140.  
  141. 3.3 Settings
  142. ------------
  143.  
  144. NoteBook Settings Dialog
  145. ------------------------
  146.  
  147.   TaskBox Settings page 1
  148.   ------------------------
  149.  
  150.     Display
  151.     -------
  152.     This is used to decide what information appears on the TaskBox.
  153.  
  154.     (auto) task top
  155.     ---------------
  156.         when checked task's are automatically raised to top when a task button gains
  157.     input focus( or when mouse stops over a button )
  158.  
  159.     Maximum/Minimum width
  160.     ---------------------
  161.       The slider and spinbutton control on this page allows the width of each task
  162.     window on the TaskBox to be customized.
  163.  
  164.     NB: these will be disabled if display is set to Icon only
  165.  
  166.     Button Actions
  167.     --------------
  168.       This group is used to customize the menu shortcuts. For both mouse
  169.     buttons you can choose one of the following options.
  170.  
  171.             (1) Minimize/Restore  --  If window can't be minimized and can be hidden it will
  172.                                         hidden instead
  173.             (2) Maximize/Restore  --
  174.             (3) Switch to.        --  Switch to this task
  175.             (4) lower             --  change the windows z-order
  176.  
  177.   TaskBox Settings page 2
  178.   ------------------------
  179.  
  180.     Activation Bar Pos
  181.     -------------------
  182.       The activation bar is the bar( along the bottom of the screen the first time you run
  183.     the program), that causes the TaskBox to be pushed to the front of the screen when the
  184.     mouse moves over it.
  185.  
  186.  
  187.     Activation Bar width/height
  188.     ---------------------------
  189.       This lets you choose the width( height) of the bar.
  190.         Hint! to change the activation bars colour set it`s width to a higher value
  191.           ( say 20) before dropping a colour from a colour pallete this will help
  192.           prevent missing the bar and changing the colour of the desktop.
  193.         Hint! to disable the activation bar set its width to 0( if TaskBox to Edge
  194.             isn`t checked to activate it you'llhave to select it from the window list)
  195.  
  196.     TaskBox to edge
  197.     ---------------
  198.       With this option checked the TaskBox will be snapped to the edge of the screen. The
  199.     edge of the screen is same edge as the Activation Bar.
  200.       Without this option checked the TaskBox will remain in the same position.
  201.  
  202.  
  203.     Bubble help
  204.     -----------
  205.         switch the bubble help on/off.
  206.  
  207.     Invisible activation bar
  208.     ------------------------
  209.         Make the activation bar invisible. It has the same width as when visible.
  210.  
  211.  
  212.     Remove List ( the list box )
  213.     -----------
  214.      This contains a list of all the programs that you have chosen to remove
  215.    from the TaskBox.
  216.      By Selecting the tasks and selecting "Remove from list" the task's selected will
  217.    no longer be removed from the TaskBox.
  218.     You can add new tasks to be removed by typeing into the entry box and pressing
  219.    enter.
  220.     ( You can include wildcards currently only understands ?( any single character)
  221.       and *( any number of characters). )
  222.    Hint! to remove all wps folders enter "* - * view" into this field
  223.  
  224.  
  225.   TaskBox Settings page 3
  226.   ------------------------
  227.  
  228.    auto lower
  229.    ----------
  230.       Set TaskBox to bottom of z-order when not active.
  231.  
  232.    always top
  233.    ----------
  234.       Keep TaskBox on top of all windows
  235.  
  236.    adjust maximized window positions
  237.    ---------------------------------
  238.       Adjust the sie of maximised windows so the taskbox isn't covered.
  239.    Note: if the taskbox isn't on the edge of the screen I would recommend turning this
  240.         option off.
  241.  
  242.    TaskBox Always Visible
  243.    ----------------------
  244.       As it says if this is checked the TaskBox will remain visible all the time.
  245.     NB: it does not automatically float to the top( unless always top is checked) so it
  246.         may be covered by other windows.
  247.  
  248.    Keep on desktop
  249.    ---------------
  250.      with this checked you won't be able to move the Taskbox off the desktop.
  251.  
  252.    Lock size/pos
  253.    -------------
  254.      Prevent the TaskBox from being accidently moved/resized.
  255.  
  256.    Small border
  257.    ------------
  258.      Give TaskBox the smallest border possible.
  259.  
  260. NB:  All TaskBox's settings are saved into TaskBox.ini, so if the worst comes to the
  261. worst you can always delete this file and revert to the default settings, This file can be
  262. located in the same directory as the executable, but it may be hidden.
  263.  
  264. 4.  Getting in Touch
  265. -------------------
  266. e-mail:             sorry temporalily not connected, but as soon as I get reconnected
  267.                     I'll release a new version with my new e-mail address.
  268.  
  269.     If you use this program and like it, let me know by sending an e-mail message to
  270. me or better yet send a postcard with any comments to:-
  271.  
  272.          41 Abbot Court,
  273.          Gateshead,
  274.          Tyne & Wear,
  275.          NE8 3JY,
  276.          ENGLAND.
  277.  
  278.     If you don't like this program, discover any bugs or have any suggestions, please let
  279. me know why or what they are by e-mailing a message to the address at the top of the
  280. document.
  281.  
  282.  
  283.  
  284. 4.1 Updates
  285. -----------
  286.     As soon I get connected at home, I'll send a new version to various ftp sites.
  287.  
  288. 5 Misc.
  289. -------
  290.     TODO
  291.             -   allow the user to choose an alternative icons for a programs
  292.             -   better documentation
  293.  
  294.  
  295.     Thanks  -   to everyone who has made suggestions, etc( too many to list but you
  296.                 know who you are )
  297.  
  298. 6 Legal Stuff
  299. -------------
  300. TaskBox is (c) Copyright 1996-1997 by Kevin Ash.
  301.  
  302. TaskBox is distributed in the hope that it will be useful, but with
  303. ABSOLUTELY NO WARRANTY; without even the implied warranty of MERCHANTABILITY
  304. or FITNESS FOR A PARTICULAR PURPOSE.
  305.